How To Install PCC in a Linux Headless Environment
Required Action
Before starting the steps below, make sure you have downloaded the necessary RPM or DEB package to the following location: /home/username/Downloads
The '#' sign in command examples denotes running the command as the root user. All command lines preceded by the '>' sign are the example output of that command, where applicable.
Step 1: Install LibreOffice
Install LibreOffice (if it was not already installed with your distribution). Download and install it from the Package Manager on your distribution. If it is not available to download from the Package Manager, then download it from here: http://www.libreoffice.org/download
CentOS / Red Hat / Fedora
- Check to see if a recent version of the CentOS/Red Hat/Fedora release includes LibreOffice in the standard repository by running the following commands:
Example |
Copy Code
|
# yum update
# yum search libreoffice
|
- If the release is available, install it through the Package Manager by running this command:
Example |
Copy Code
|
# yum install libreoffice
|
Manual Installation of LibreOffice in CentOS
- Verify that the LibreOffice package has been downloaded to: /home/username/Downloads. Run the following commands:
Example |
Copy Code
|
# tar xvf LibreOffice_4.2.4.2_Linux_x86-64_rpm.tar.gz
# yum install LibreOffice_4.2.4.2_Linux_x86-64_rpm/RPMS/*.rpm
|
- This should install LibreOffice to /opt. To verify, run the following command:
Example |
Copy Code
|
# ls /opt | grep libreoffice
> libreoffice4.2
|
- Write down the location because you will need it below in the Setup portion of the installation process. (Example location: /opt/libreoffice4.2)
Ubuntu / Debian
- Install LibreOffice through the Package Manager (recent versions of the release should include LibreOffice in the standard repository). Run the following command:
Example |
Copy Code
|
# apt-get install libreoffice
|
Step 2: Install the Prizm Content Connect Package
CentOS / Red Hat / Fedora
- Run the following command to install the package:
Example |
Copy Code
|
# yum install --nogpgcheck prizmcc_<version>.x86_64.rpm
|
Ubuntu / Debian
- Run the following commands to install the package:
Example |
Copy Code
|
# apt-get install gdebi
# gdebi prizmcc_<version>.amd64.deb
|
Step 3: Setup
- Run the following commands to initiate setup:
Example |
Copy Code
|
# cd /usr/share/prizm
# sh ./setup.sh
|
- The setup may prompt you for the LibreOffice location if it was not already installed on your distribution. Provide the location which you obtained in the 'Step 1 - Install LibreOffice' section above. (Example location: /opt/libreoffice4.1)
The setup script will now invoke a text-based wizard for licensing.
|
To install a license at the end of the evaluation period, (for example, a deployment license), run the following command:
Example |
Copy Code
|
# ./setup.sh eval get youremail@example.com
|
If you already have a license for PCC, you can use one of the other licensing options, detailed in the Command Line Mode Licensing section of the help.
|
- To confirm the licensing has succeeded, run the following command, which will output your license key:
Example |
Copy Code
|
# cat ./conf/proxyserver_jar.properties | grep license_key
> license_key=<long string>
|
-
If PCC has started and no errors have been reported, then the installation process is complete.
|
However, if you have an error in the Proxy Server log stating that it cannot connect to the Office converter Worker-1 instance, then you must continue to the 'Step 4 - Running an X Virtual Framebuffer' section below. |
Step 4: Running an X Virtual Framebuffer Server
A full version of the X11 server is not required to run PCC. However, the minimum requirement is the X Virtual Framebuffer Server, which you can install and run separately from an entire X11 instance.
- To install the X Virtual Framebuffer Server, run the following command:
Debian/Ubuntu
Example |
Copy Code
|
# sudo apt-get install xvfb
|
Red Hat / CentOS
Example |
Copy Code
|
# yum install xorg-x11-server-Xvfb
|
- Start the service by running the following command, and then export the instance to the DISPLAY environment variable expected by the Prizm service:
Example |
Copy Code
|
# Xvfb :20 >/dev/null 2>&1 &
# export DISPLAY=:20
|
- Start PCC:
Example |
Copy Code
|
# /usr/share/prizm/scripts/pccis.sh start
|
Required:
The X Virtual Framebuffer Server must be running any time that the Prizm service is running.
Suggested:
It may be appropriate to create a script that will start the Xvfb service and Prizm Services (the 3 lines above) to execute whenever the machine is restarted.
- The installation process is now complete.